home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / BIRKETT / SLIPSWIT / !!ReadMe next >
Text File  |  1995-11-15  |  10KB  |  202 lines
  1. SlipSwitch_0.04.spk    15 November 1995
  2. ===================
  3.  
  4. ftp://cslib.ecs.soton.ac.uk/pub/Acorn/freenet/r.birkett/SlipSwitch_0.04.spk
  5.  
  6. ** I will try to respond to questions raised in comp.sys.acorn.networking or
  7. ** emailed to the support address below, but please check you have read
  8. ** the documentation in this ReadMe file and the configuration file first.
  9.  
  10. Thanks to the efforts of various people over the last few months we are now
  11. able to use FreeNet for nearly everything.  For a little while longer, however,
  12. most of us will still need to use !TCPIP (the RISC OS port of the 'KA9Q'
  13. integrated TCP/IP access package by Phil Karn) to get our mail, in conjunction
  14. with FreeNet.  This script allows you freely to switch between these two
  15. systems without needing to redial... among other things.
  16.  
  17. The SlipDial script evolved over the summer of 1995 to do as much as possible
  18. in a user-friendly way, hence its name "DoItAll"!.  A lot of people now use it
  19. to switch between !TCPIP and FreeNet (and back again) during a SLIP connection,
  20. and it seems reasonably robust.  Versions from 0.02 onwards use a self-
  21. documenting configuration file, which for most purposes will be the only file
  22. which needs to be edited by the user.  There is also a lot of flexibility to do
  23. different things at different times (eg. you could download news only during
  24. the wee-hours auto-login, and not when you login manually).
  25.  
  26. To support some of the optional features of the setup, I've included a few
  27. other patches - see "Archive contents" for details.
  28.  
  29. Note: DoItAll has NOT been tested with Phillip Temple's FreeNet starter pack
  30. ("!Acornet").  It should be thought of as an *alternative* to the Acornet front
  31. end.  Make sure all the applications inside !Acornet have been 'seen' by the
  32. filer (or, better still, move them to be outside !Acornet altogether), and then
  33. launch !SlipDial directly.
  34.  
  35. Installation - ** please read carefully **
  36. ------------
  37.  
  38. Upgrading from a previous version:
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40. From version 0.01:
  41.   Make a note of the options you have selected (eg. which PoPs to present on
  42. the menu, what time to do the auto-login, whether to kill TTFN, etc).  You will
  43. have to re-enter these after installation of this version.  Sorry about that,
  44. but any future upgrades should then be much easier.  The 'offline' versions of
  45. AutoExec and Config are now called AutoExecO and ConfigO - you may need to edit
  46. these (or possibly just move your existing -L files over the -O ones) after
  47. installation.
  48.  
  49. From versions 0.02 or 0.03:
  50.   Drag the !SlipDial icon from the archive over your existing !SlipDial
  51. application.  Your existing configuration will be preserved.  You should check
  52. that you are using the appropriate PoP, now that there are many other numbers
  53. available.  Run DIAclearup to remove the 'first installation' support files.
  54.  
  55. New installations:
  56. ~~~~~~~~~~~~~~~~~
  57.  (1) Drag the !SlipDial icon from the archive over your existing !SlipDial
  58. application.  Do the same with !TCPIP, !TCPIPUser, and also with !ArcFax if you
  59. have that.
  60.  
  61.  (2) Run !SlipDial.  Open the Choices window, and choose the new script to
  62. auto-run from the menu or by typing "SlipDial:DoItAll" into the writable icon. 
  63. Save the choices.  Now quit and restart !SlipDial.
  64.  
  65.  (3) If you have not used DoItAll version 0.02+ before, the script will check
  66. for a file called "demonconfg", which will have been created by the original
  67. Demon script from the !TCPIP starter pack.  If there is such a file, it will be
  68. converted; if not, you will be asked to enter some basic information like your
  69. nodename and password.  NOTE: different releases of the starter pack may have
  70. produced slightly different demonconfg files: you MUST carefully check the
  71. DoItAllCfg file if it has been generated from an existing demonconfg file.
  72.  
  73.  (4) There will now be a file "DoItAllCfg" in the !SlipDial.Scripts directory. 
  74. Load it into an editor (by double-clicking on it), and check carefully that all
  75. the options are as you want them - the file is fully documented.  You can
  76. modify this file at any time, but note that changes will not be effective until
  77. you restart the script (by restarting !SlipDial, or select "Restart" in the
  78. dial menu).  When you are happy with your settings, run the command file
  79. "DIAclearup".  If you are sure you won't want to go back to the old script, you
  80. could also delete the "demonconfg" file, since DoItAll does not use it once
  81. "DoItAllCfg" is in place.
  82.  
  83.  
  84. Usage
  85. -----
  86.  
  87.  (1) Choose the initial stack to use from the menu of the stack icon (the
  88. left-hand one with the circle around it).
  89.  (2) Choose the PoP to call from the main dial menu (in the SlipDial status
  90. window), or click on the stack icon to select your configured local PoP.
  91.  (3) To switch to a different stack, wait for the connection to be idle (ie.
  92. NOT in the middle of a download!) and select the new stack from the stack icon
  93. menu.  Repeat as required.
  94.  (4) To disconnect, select "Shutdown" from either menu.
  95.  (5) If you're connecting late at night and don't want to bother with the next
  96. auto-login (eg. because you've already downloaded plenty of news), select "Skip
  97. next" from the dial menu.
  98.  
  99.  
  100. Archive contents
  101. ----------------
  102.  
  103. !SlipDial
  104.   Drop this over your existing !SlipDial application (version 0.34d or 0.35a -
  105. I don't know if it will work with earlier versions).  It adds a new script
  106. "DoItAll", along with some supporting files.
  107.   Note there is also a replacement !Run file, to allocate enough space for the
  108. extra icons, and some hi-res sprites (thanks to Andy Ward).  To make full use
  109. of these sprites, you need to patch the !SlipDial.!RunImage - Andy's
  110. instructions for doing this are in the file "HiResDoc".
  111.  
  112. !ArcFax
  113.   For those of you who leave your machine on most of the time with ArcFax
  114. running, this contains two files which can be used to 'restart' ArcFax
  115. automatically when your Net session has finished.  Drop it over your existing
  116. !ArcFax application, and then set the "controlArcfax" option in your
  117. configuration file.
  118.  
  119. !TCPIP
  120. !TCPIPUser
  121.   To permit use of the "Offline" and "Auto-login" features, these contain a
  122. replacement !Run file, and some extra files based on AutoExec and Config with
  123. an extra letter suffix (O for Offline, and A for Autologin).  These are used
  124. instead of the normal "AutoExec" and "Config" files when you choose to run KA9Q
  125. offline or unattended.  As supplied, they will just 'include' the normal files
  126. - I suggest you change AutoExecO so it doesn't try to do things like kick smtp,
  127. kick nntp, nntp addserver, time get, etc, all of which will fail with nothing
  128. to connect to.  ConfigA has a "tcp hangup" command included - I suggest you
  129. keep something of the sort here, otherwise your phone bill may grow more than
  130. it does anyway!
  131.  
  132.  
  133. Technical stuff
  134. ---------------
  135.  
  136. The switching of tasks is all done by a separate BASIC program.  I know that
  137. SlipDial has facilities for task management, but I wanted better control over
  138. it.  Anyway, FreeNet is module-based, and I haven't found a simple way of
  139. getting SlipDial to do anything with modules at all.
  140.  
  141. Arbitrary things can be set to happen before and after a connection: this is
  142. all controlled from the file !SlipDial.Scripts.DIAappctrl.  As supplied, it can
  143. stop and restart TTFN, Newsbase and ArcFax, controlled by options in the
  144. configuration file; but any script command could be put here for special
  145. purposes.
  146.  
  147.  
  148. Small print
  149. -----------
  150.  
  151. This package is released as FreeWare with no guarantees of any kind.  If you
  152. have problems with it after reading this file, email me on the address below
  153. and I'll try to help.  You may (and probably should) modify the configuration
  154. files suit your own circumstances, but if you pass it on to anyone else, you
  155. must do so in its original unmodified form, with this ReadMe file intact.  I
  156. retain copyright.  It may not be distributed commercially or included in any
  157. other distributed package, or uploaded to any FTP site, without my express
  158. permission.
  159.  
  160. There are probably still a few 'features' lurking in here somewhere, especially
  161. if this version is quite old.  The copy on cslib.ecs.soton.ac.uk is currently
  162. the only one that I maintain - if you found this anywhere else or someone gave
  163. you a copy, you may have an earlier version than the latest.  The corollary is
  164. that I would like to know of any problems you find - with the fix if you have
  165. one! - so I can keep the cslib copy up to date.
  166.  
  167. None of this would have been possible without the original scripts that people
  168. have posted to newsgroups or included in starter-packs.  Credit is due to Rob
  169. Orwin, James Woodman, Alan Fitch, Andy Ward, and especially to Graham Allan for
  170. writing !SlipDial itself.  If anyone else recognises some of their code here,
  171. let me know and I'll mention them in this file next time!
  172.  
  173. Share + enjoy!
  174.  
  175. Richard Birkett <support@musicbox.demon.co.uk>
  176.  
  177.  
  178. Version history and Distribution
  179. --------------------------------
  180.  
  181. 0.01 06/09/95 First release version
  182.               [uploaded to cslib]
  183.  
  184. 0.02 27/09/95 Complete rewrite.  There are now separate files for configuration
  185.               and provider details: you shouldn't now need to edit the script
  186.               itself at all.  See this !!ReadMe file and the annotated
  187.               configuration file for details.
  188.               Bug fixed (could sometimes fail to kill the KA9Q stack).  The
  189.               same bug is present in SlipDial's task/kill=id code - beware!
  190.               [uploaded to cslib]
  191.  
  192. 0.03 28/09/95 Bug fixed in configuration file (problem with dial menu items).
  193.               [uploaded to cslib]
  194.  
  195. 0.04 15/11/95 Errors "too many case levels" and "no such label" fixed.
  196.               Attempts to dial while already connected will not now disconnect.
  197.               New '100% coverage' Demon PoP numbers added.
  198.               Control of other applications (like ArcFax and TTFN) is now in a
  199.               separate file, for easier modification by the user.
  200.               [uploaded to cslib]
  201.  
  202.